--系统组件，用于管理动画状态
--所有具有动画表现的实体都需要该组件
--同时存在于主客端
--添加方式：inst.entity:AddAnimState()



--属性

















--方法
--[[1.SetFinalOffset:设置动画的渲染层级偏移
使用示例：inst.AnimState:SetFinalOffset(1)
参数：
    1.类型: 整数
    2.范围: -7 到 7 (根据 constants.lua 中的 FINALOFFSET_MIN = -7 和 FINALOFFSET_MAX = 7)
    3.是否可选: 否，必须提供参数
    4.默认值: 无默认值，必须显式设置
    5.作用：
        1.正数值 (如 1, 2, 3): 使物体渲染在前层，数值越大越靠前
        2.负数值 (如 -1, -2, -3): 使物体渲染在后层，数值越小越靠后
        3.默认层级为0
返回值：
    1.无返回值
实现流程：
    1.接收一个整数偏移值作为参数
    2.将该偏移值应用到动画状态的渲染层级
    3.影响该实体在渲染管线中的排序顺序
]]



--[[2.SetBank:设置动画的动画集，即scml文件中的动画集名称，只有指定动画集，才能播放对应动画集中的动画
使用示例：inst.AnimState:SetBank("tbat_sfx_flame")
参数：
    1.类型: 字符串
    3.是否可选: 否，必须提供参数
    4.默认值: 无默认值
    5.作用：
        1.指定的动画资源包中的动画集名称
返回值：
    1.无返回值
实现流程：
    1.无
]]

--[[3.SetBuild:设置动画的构建(Build)，指定使用哪个纹理图集，即使用的动画zip包的名称
使用示例：inst.AnimState:SetBuild("tbat_sfx_flame")
参数：
    1.类型: 字符串
    3.是否可选: 否，必须提供参数
    4.默认值: 无默认值
    5.作用：
        1.指定的纹理图集的文件名，即动画zip包的名称
返回值：
    1.无返回值
实现流程：
    1.无
]]


--[[4.PlayAnimation:播放已经设置好的动画集下的指定动画
使用示例：inst.AnimState:PlayAnimation("red", true)
参数1：
    1.类型: 字符串
    3.是否可选: 否，必须提供参数
    4.默认值: 无默认值
    5.作用：
        1.指定要播放的动画名称
参数2
    1.类型: 布尔值
    3.是否可选: 是，可选参数
    4.默认值: false (不循环)
    5.作用：
        1.控制动画是否循环播放，false即动画播放一次后停止
返回值：
    1.无返回值
实现流程：
    1.无
]]


























--补充
--[[
    1.指定一个物体的默认动画的流程
        1.SetBuild告诉系统该prefab的动画包的图集路径（即引用的动画zip包）
        2.SetBank告诉系统使用指定zip包中的哪个动画集
        3.PlayAnimation告诉系统prefab默认播放动画集中的哪个动画

]]